<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
    <title>Getting Started with Replicated Berkeley DB Applications</title>
    <link rel="stylesheet" href="gettingStarted.css" type="text/css" />
    <meta name="generator" content="DocBook XSL Stylesheets V1.73.2" />
    <link rel="start" href="index.html" title="Getting Started with Replicated Berkeley DB Applications" />
    <link rel="next" href="preface.html" title="Preface" />
  </head>
  <body>
    <div xmlns="" class="navheader">
      <div class="libver">
        <p>Library Version 11.2.5.3</p>
      </div>
      <table width="100%" summary="Navigation header">
        <tr>
          <th colspan="3" align="center">Getting Started with Replicated Berkeley DB Applications</th>
        </tr>
        <tr>
          <td width="20%" align="left"> </td>
          <th width="60%" align="center"> </th>
          <td width="20%" align="right"> <a accesskey="n" href="preface.html">Next</a></td>
        </tr>
      </table>
      <hr />
    </div>
    <div class="book" lang="en" xml:lang="en">
      <div class="titlepage">
        <div>
          <div>
            <h1 class="title"><a id="idp11248"></a>Getting Started with Replicated Berkeley DB Applications</h1>
          </div>
          <div>
            <div class="legalnotice">
              <a id="idp76904"></a>
              <p class="legalnotice-title">
                <b>Legal Notice</b>
              </p>
              <span>
        <p>
            This documentation is distributed under an open source license.
            You may review the terms of this license at:
            <a class="ulink" href="http://www.oracle.com/technetwork/database/berkeleydb/downloads/oslicense-093458.html" target="_top">http://www.oracle.com/technetwork/database/berkeleydb/downloads/oslicense-093458.html</a>
            
            
        </p>

        <p>
                Oracle, Berkeley DB,
                
                
                and
                Sleepycat are trademarks or registered trademarks of
                Oracle. All rights to these marks are reserved.
                No third-party use is permitted without the
                express prior written consent of Oracle.
        </p>
        
        <p>
            Other names may be trademarks of their respective owners.
        </p>
        <p>
            To obtain a copy of this document's original source code, please
            submit a request to the Oracle Technology Network forum at:
            <a class="ulink" href="http://forums.oracle.com/forums/forum.jspa?forumID=271" target="_top">http://forums.oracle.com/forums/forum.jspa?forumID=271</a>
            
            
        </p>
    </span>
            </div>
          </div>
          <div>
            <p class="pubdate">9/9/2013</p>
          </div>
        </div>
        <hr />
      </div>
      <div class="toc">
        <p>
          <b>Table of Contents</b>
        </p>
        <dl>
          <dt>
            <span class="preface">
              <a href="preface.html">Preface</a>
            </span>
          </dt>
          <dd>
            <dl>
              <dt>
                <span class="sect1">
                  <a href="preface.html#conventions">Conventions Used in this Book</a>
                </span>
              </dt>
              <dt>
                <span class="sect1">
                  <a href="moreinfo.html">For More Information</a>
                </span>
              </dt>
              <dd>
                <dl>
                  <dt>
                    <span class="sect2">
                      <a href="moreinfo.html#contact_us">Contact Us</a>
                    </span>
                  </dt>
                </dl>
              </dd>
            </dl>
          </dd>
          <dt>
            <span class="chapter">
              <a href="introduction.html">1. Introduction</a>
            </span>
          </dt>
          <dd>
            <dl>
              <dt>
                <span class="sect1">
                  <a href="introduction.html#overview">Overview</a>
                </span>
              </dt>
              <dd>
                <dl>
                  <dt>
                    <span class="sect2">
                      <a href="introduction.html#repenvirons">Replication Environments</a>
                    </span>
                  </dt>
                  <dt>
                    <span class="sect2">
                      <a href="introduction.html#repdbs">Replication Databases</a>
                    </span>
                  </dt>
                  <dt>
                    <span class="sect2">
                      <a href="introduction.html#commlayer">Communications Layer</a>
                    </span>
                  </dt>
                  <dt>
                    <span class="sect2">
                      <a href="introduction.html#masterselect">Selecting a Master</a>
                    </span>
                  </dt>
                </dl>
              </dd>
              <dt>
                <span class="sect1">
                  <a href="repadvantage.html">Replication Benefits</a>
                </span>
              </dt>
              <dt>
                <span class="sect1">
                  <a href="apioverview.html">The Replication APIs</a>
                </span>
              </dt>
              <dd>
                <dl>
                  <dt>
                    <span class="sect2">
                      <a href="apioverview.html#repframeworkoverview">Replication Manager Overview</a>
                    </span>
                  </dt>
                  <dt>
                    <span class="sect2">
                      <a href="apioverview.html#repapioverview">Replication Base API Overview</a>
                    </span>
                  </dt>
                </dl>
              </dd>
              <dt>
                <span class="sect1">
                  <a href="elections.html">Holding Elections</a>
                </span>
              </dt>
              <dd>
                <dl>
                  <dt>
                    <span class="sect2">
                      <a href="elections.html#influencingelections">Influencing Elections</a>
                    </span>
                  </dt>
                  <dt>
                    <span class="sect2">
                      <a href="elections.html#winningelections">Winning Elections</a>
                    </span>
                  </dt>
                  <dt>
                    <span class="sect2">
                      <a href="elections.html#switchingmasters">Switching Masters</a>
                    </span>
                  </dt>
                </dl>
              </dd>
              <dt>
                <span class="sect1">
                  <a href="permmessages.html">Permanent Message Handling</a>
                </span>
              </dt>
              <dd>
                <dl>
                  <dt>
                    <span class="sect2">
                      <a href="permmessages.html#permmessagenot">When Not to Manage
                            Permanent Messages</a>
                    </span>
                  </dt>
                  <dt>
                    <span class="sect2">
                      <a href="permmessages.html#permmanage">Managing Permanent Messages</a>
                    </span>
                  </dt>
                  <dt>
                    <span class="sect2">
                      <a href="permmessages.html#permimplement">Implementing Permanent
                    Message Handling</a>
                    </span>
                  </dt>
                </dl>
              </dd>
            </dl>
          </dd>
          <dt>
            <span class="chapter">
              <a href="txnapp.html">2. Transactional Application</a>
            </span>
          </dt>
          <dd>
            <dl>
              <dt>
                <span class="sect1">
                  <a href="txnapp.html#appoverview">Application Overview</a>
                </span>
              </dt>
              <dt>
                <span class="sect1">
                  <a href="simpleprogramlisting.html">Program Listing</a>
                </span>
              </dt>
              <dd>
                <dl>
                  <dt>
                    <span class="sect2">
                      <a href="simpleprogramlisting.html#main_c">Function: main()</a>
                    </span>
                  </dt>
                  <dt>
                    <span class="sect2">
                      <a href="simpleprogramlisting.html#create_env_c">Function: create_env()</a>
                    </span>
                  </dt>
                  <dt>
                    <span class="sect2">
                      <a href="simpleprogramlisting.html#env_init_c">Function: env_init()</a>
                    </span>
                  </dt>
                  <dt>
                    <span class="sect2">
                      <a href="simpleprogramlisting.html#doloop_c">Function: doloop()</a>
                    </span>
                  </dt>
                  <dt>
                    <span class="sect2">
                      <a href="simpleprogramlisting.html#printstocks_c">
                            <span>Function: print_stocks()</span>
                            
                            
                    </a>
                    </span>
                  </dt>
                </dl>
              </dd>
            </dl>
          </dd>
          <dt>
            <span class="chapter">
              <a href="repapp.html">3. The DB Replication Manager</a>
            </span>
          </dt>
          <dd>
            <dl>
              <dt>
                <span class="sect1">
                  <a href="repapp.html#repmgr_grpmgmt">The DB_SITE Handle</a>
                </span>
              </dt>
              <dt>
                <span class="sect1">
                  <a href="rep_init_code.html">
        Starting and Stopping Replication
    </a>
                </span>
              </dt>
              <dd>
                <dl>
                  <dt>
                    <span class="sect2">
                      <a href="rep_init_code.html#election_flags">Managing Election Policies</a>
                    </span>
                  </dt>
                  <dt>
                    <span class="sect2">
                      <a href="rep_init_code.html#thread_count">Selecting the Number of Threads</a>
                    </span>
                  </dt>
                </dl>
              </dd>
              <dt>
                <span class="sect1">
                  <a href="repmgr_init_example_c.html">Adding the Replication Manager to
                <span>ex_rep_gsg_simple</span>
                
                
        </a>
                </span>
              </dt>
              <dt>
                <span class="sect1">
                  <a href="fwrkpermmessage.html">Permanent Message Handling</a>
                </span>
              </dt>
              <dd>
                <dl>
                  <dt>
                    <span class="sect2">
                      <a href="fwrkpermmessage.html#fmwrkpermpolicy">Identifying Permanent Message Policies</a>
                    </span>
                  </dt>
                  <dt>
                    <span class="sect2">
                      <a href="fwrkpermmessage.html#fmwrkpermtimeout">Setting the Permanent Message Timeout</a>
                    </span>
                  </dt>
                  <dt>
                    <span class="sect2">
                      <a href="fwrkpermmessage.html#perm2fmwrkexample">Adding a Permanent Message Policy to 
                            <span>ex_rep_gsg_repmgr</span>
                            
                            
                    </a>
                    </span>
                  </dt>
                </dl>
              </dd>
              <dt>
                <span class="sect1">
                  <a href="electiontimes.html">Managing Election Times</a>
                </span>
              </dt>
              <dd>
                <dl>
                  <dt>
                    <span class="sect2">
                      <a href="electiontimes.html#electiontimeout">Managing Election Timeouts</a>
                    </span>
                  </dt>
                  <dt>
                    <span class="sect2">
                      <a href="electiontimes.html#electretrytime">Managing Election Retry Times</a>
                    </span>
                  </dt>
                </dl>
              </dd>
              <dt>
                <span class="sect1">
                  <a href="fmwrkconnectretry.html">Managing Connection Retries</a>
                </span>
              </dt>
              <dt>
                <span class="sect1">
                  <a href="heartbeats.html">Managing Heartbeats</a>
                </span>
              </dt>
            </dl>
          </dd>
          <dt>
            <span class="chapter">
              <a href="fwrkmasterreplica.html">4. Replica versus Master Processes</a>
            </span>
          </dt>
          <dd>
            <dl>
              <dt>
                <span class="sect1">
                  <a href="fwrkmasterreplica.html#determinestate">Determining State</a>
                </span>
              </dt>
              <dt>
                <span class="sect1">
                  <a href="processingloop.html">Processing Loop</a>
                </span>
              </dt>
              <dt>
                <span class="sect1">
                  <a href="exampledoloop.html">Example Processing Loop</a>
                </span>
              </dt>
              <dd>
                <dl>
                  <dt>
                    <span class="sect2">
                      <a href="exampledoloop.html#runningit">Running It</a>
                    </span>
                  </dt>
                </dl>
              </dd>
            </dl>
          </dd>
          <dt>
            <span class="chapter">
              <a href="addfeatures.html">5. Additional Features</a>
            </span>
          </dt>
          <dd>
            <dl>
              <dt>
                <span class="sect1">
                  <a href="addfeatures.html#delayedsync">Delayed Synchronization</a>
                </span>
              </dt>
              <dt>
                <span class="sect1">
                  <a href="manageblock.html">Managing Blocking Operations</a>
                </span>
              </dt>
              <dt>
                <span class="sect1">
                  <a href="autoinit.html">Stop Auto-Initialization</a>
                </span>
              </dt>
              <dt>
                <span class="sect1">
                  <a href="rywc.html">Read-Your-Writes Consistency</a>
                </span>
              </dt>
              <dt>
                <span class="sect1">
                  <a href="c2ctransfer.html">Client to Client Transfer</a>
                </span>
              </dt>
              <dd>
                <dl>
                  <dt>
                    <span class="sect2">
                      <a href="c2ctransfer.html#fmwrkpeerserver">Identifying Peers</a>
                    </span>
                  </dt>
                </dl>
              </dd>
              <dt>
                <span class="sect1">
                  <a href="bulk.html">Bulk Transfers</a>
                </span>
              </dt>
            </dl>
          </dd>
        </dl>
      </div>
    </div>
    <div class="navfooter">
      <hr />
      <table width="100%" summary="Navigation footer">
        <tr>
          <td width="40%" align="left"> </td>
          <td width="20%" align="center"> </td>
          <td width="40%" align="right"> <a accesskey="n" href="preface.html">Next</a></td>
        </tr>
        <tr>
          <td width="40%" align="left" valign="top"> </td>
          <td width="20%" align="center"> </td>
          <td width="40%" align="right" valign="top"> Preface</td>
        </tr>
      </table>
    </div>
  </body>
</html>
